% -*-LaTeX-*-
% Converted automatically from troff to LaTeX by tr2tex on Tue Dec 18 11:07:53 1990
% tr2tex was written by Kamal Al-Yahya at Stanford University
% (Kamal%Hanauma@SU-SCORE.ARPA)


\documentstyle[troffman]{article}
\begin{document}
%
% input file: pbm2ps.1
%
\phead{PBM2PS}{1}{25-Jun-90}

%.CM 3
\shead{NAME}
pbm2ps -- convert a PBM file to postscript (option for Scribe files)
\shead{SYNOPSIS}
\nofill
pbm2ps [ -s ] [ scale ] $<$ pbm $>$ postscript
\fill
\shead{DESCRIPTION}
\par
This is an enhanced version of Poskanzer's
{\it pbmtops}
command that includes an option to generate "bare" files for including
in documents (the
{\bf -s}
or scribe option).  It also prints the title at the top, if there is
one attached to the image.
\par\vspace{1.0\baselineskip}
The
{\it scale}
if given must be an integer number which indicates how many output dots
(at 300 dpi) are used to render a single pixel.  The default is 1.
\shead{EXAMPLE}
\par
Given a 480 by 600 pixel bitmap, create a postscript file with the
largest integral scaling factor that fits on a regular page:
\par\vspace{1.0\baselineskip}
    \% pbm2ps $<$ foo.1bit $>$ foo.PS
\par\vspace{1.0\baselineskip}
Given the same bitmap, create a postscript file
with each input pixel represented by a 2x2
block of 300 dpi pixels on the output page (scaling factor 2):
\par\vspace{1.0\baselineskip}
    \% pbm2ps 2 $<$ foo.1bit $>$ foo.PS
\par\vspace{1.0\baselineskip}
Note that the resulting image will be 3.2 inches wide and 4 inches tall
(pixels * scale / 300 dpi).
\par\vspace{1.0\baselineskip}
Create the same image, but don't include document structuring commands
(this allows the file to be included in other documents by formatters
such as Scribe and TeX).
\par\vspace{1.0\baselineskip}
    \% pbm2ps -s 2 $<$ foo.1bit $>$ foo.PS
\shead{SEE ALSO}
fbm2ps(1) for converting grayscale files.
fbm(1) for general discussion, pbm(1) for PBM routines.
\shead{BUGS}
None known.
\shead{HISTORY}
Copyright (C) 1989,1990 by Michael Mauldin.  Permission is granted
to use this file in whole or in part for any purpose, educational,
recreational or commercial, provided that this copyright notice
is retained unchanged.  This software is available to all free of
charge by anonymous FTP and in the UUNET archives.
\begin{TPlist}{25-Jun-90  Michael Mauldin at Carnegie Mellon University}
\item[{25-Jun-90  Michael Mauldin at Carnegie Mellon University}]
Release 1.0 mlm@cs.cmu.edu
\item[{07-Mar-89  Michael L. Mauldin at Carnegie Mellon University}]
Beta release (version 0.9) mlm@cs.cmu.edu
\end{TPlist}
\end{document}
